home *** CD-ROM | disk | FTP | other *** search
/ Turnbull China Bikeride / Turnbull China Bikeride - Disc 2.iso / ACORNUSERS / EMULATOR / MIRACLE / !Miracle / !Help < prev    next >
Text File  |  1998-07-23  |  8KB  |  208 lines
  1. ***************************************************************************
  2. **                                                                       **
  3. **                        -- == MIRACLE == --                            **
  4. **                           Version  0.10                               **
  5. **                                                                       **
  6. **       A Fast Sega Master System Emulator for the Acorn Platform       **
  7. **                                                                       **
  8. **             by Richard Talbot-Watkins (rst20@cam.ac.uk)               **
  9. **        and Matthew Godbolt (matthew@willothewisp.demon.co.uk)         **
  10. **                                                                       **
  11. **                          17th March 1998                              **
  12. **                                                                       **
  13. ***************************************************************************
  14.  
  15.  
  16. Contents
  17. ========
  18.  
  19. 1) Terms and conditions of use
  20. 2) Disclaimer
  21. 3) About !Miracle
  22. 4) Instructions
  23. 5) Known problems
  24. 6) Future releases
  25. 7) Contacting the authors
  26. 8) Acknowledgements
  27.  
  28.  
  29. Terms and conditons of use
  30. ==========================
  31.  
  32. !Miracle is FREEWARE and may be freely distributed, provided no charge
  33. other than the medium used to transfer it is made.  You may only use
  34. !Miracle for your own personal and non-commercial purposes.  The code
  35. remains the intellectual property of Richard Talbot-Watkins and Matthew
  36. Godbolt.
  37.  
  38.  
  39. Disclaimer
  40. ==========
  41.  
  42. The authors cannot be held responsible for any damage caused by the use of
  43. !Miracle, and it is recommended that any work is saved before it is run.
  44. This software is not an official Sega product, and is not endorsed by Sega
  45. in any way.
  46.  
  47. It is an infringement of copyright to use SMS cartridge 'images' without
  48. also owning the original cartridge, and the authors do not condone such
  49. activities.  We are not liable for the misuse of cartridge images on this
  50. emulator.
  51.  
  52. Sega, Master System, Game Gear and Mark 3 are trademarks of Sega.
  53.  
  54.  
  55. About Miracle
  56. =============
  57.  
  58. Until recently, it was impossible to play the majority of Sega Master
  59. System games on your non-StrongArm Acorn machine.  Now thanks to a
  60. completely Acorn specific Sega Master System emulator, written in 100%
  61. hand-optimised ARM assembler, anyone with an Acorn machine can enjoy all
  62. those Sega classics.
  63.  
  64. Miracle is a near-perfect emulation of a Sega Master System, emulating
  65. everything a real European SMS could do perfectly.  If you have an ARM3
  66. or above, you can enjoy these games in real-time, with best results on an
  67. ARM7 or StrongARM.
  68.  
  69. Miracle has been in constant development since Autumn 1997, and is being
  70. continually worked upon.  This version (Version 0.01) has been released
  71. "due to popular demand", but as yet, still contains a number of rather
  72. obscure bugs, and is by no means stable!  A list of known problems with the
  73. current version is included later on in this document.  However, this
  74. version should nevertheless permit the correct operation of 95% of SMS
  75. titles.
  76.  
  77. In order to run Miracle, all that is required is an Acorn machine with at
  78. least 2Mb of RAM - it will even run on an ARM2 (albeit slowly!) - but
  79. many games are reasonably playable on even an ARM250 (most of the emulator's
  80. development was on an A3010!).  Of course, Risc PCs will give the best
  81. performance.
  82.  
  83.  
  84. Instructions
  85. ============
  86.  
  87. OK, so you've extracted the files from the archive - now what?  If you own
  88. a Risc PC, it will be necessary to install the monitor definition file
  89. provided (called "MonDef", inside !Miracle) before Miracle will run.  It is
  90. simply a 256 x 192 x 8bpp mode, with about an "inch" of border round the
  91. edge - if the supplied file is not appropriate for your monitor, it should
  92. be possible to create a suitable monitor definition file of your own with
  93. the mode editor.
  94.  
  95. The other task which may be necessary is to set the "frame skip" value.
  96. This is a way of coaxing a little more speed out of slower machines by
  97. having the emulator only refresh the screen periodically.  This is usually
  98. set to "automatic", and on ARM6 and above, should not need altering.  On an
  99. ARM250/ARM3 it may be worth setting manually: do so by editing the !Run file
  100. and changing the value given to SegaEmul$FrameSkip (3-4 is recommended for
  101. ARM250/ARM3).
  102.  
  103. I know this is maybe not satisfactory, but remember, it *is* an early
  104. release!!
  105.  
  106. Miracle will run any SMS cartridge (i.e. any .SMS file).  At the moment,
  107. Game Gear (.GG) files are not supported, but in a later release a Game Gear
  108. emulator will also be provided.
  109.  
  110. Simply run an SMS image file by setting its filetype to &0AE (not an
  111. offical filetype) and double-clicking on it (having first let the filer see
  112. Miracle of course).
  113.  
  114. Control keys are as follows:
  115.  
  116.    Player 1 Left:  Z               Player 2 Left:  Copy/End
  117.            Right:  X                       Right:  Page Down
  118.               Up:  "                          Up:  keypad 8
  119.             Down:  ?                        Down:  keypad 4
  120.            Fire1:  Space                   Fire1:  keypad 0
  121.            Fire2:  Return                  Fire2:  keypad 9
  122.           
  123.    Also -    Pause: P     Reset: f12      Quit: Escape
  124.    
  125.  
  126. Known problems
  127. ==============
  128.  
  129. As already mentioned, it's still an early form of the emulator as yet, so
  130. there are still bugs being ironed out as you read this!  Here's the list
  131. of SMS games which are known not to work at all:
  132.  
  133. Alex Kidd - the Lost Stars: Screen goes black
  134. Altered Beast: Hangs on title screen (we know why, but not the best way to
  135.   fix this one yet)
  136. Sega Chess: Hangs up eventually
  137. Speedball 2: Screen goes black
  138. Time Soldiers: Sprites incorrectly positioned
  139. Xenon 2: Crashes with black/red screen
  140. Zool: Hangs up at start of "playing" section
  141.  
  142. and here are the ones that suffer more minor ailments:
  143.  
  144. Bart Simpson vs Space Mutants: Some corrupted graphics
  145. Marble Madness: Main sprite not correctly animated
  146. Miracle Warriors: Sprite positioning problem
  147. Space Harrier: Sprite masking problem
  148. + a few others with rubbish at the top left of their title screens
  149.  
  150. These are being looked into RIGHT NOW!!
  151.  
  152.  
  153. Future releases
  154. ===============
  155.  
  156. Eventually, Miracle will sit on the iconbar, maybe multitasking in a
  157. window if you want, and provide all the usual save/load snapshot type
  158. facilities.  Plus support is planned for 9 channel FM sound, and Game
  159. Gear compatibility.
  160.  
  161. Watch Miracle's website (http://www.willothewisp.demon.co.uk/SMS) for the
  162. latest news and releases.
  163.  
  164.  
  165. Contacting the authors
  166. ======================
  167.  
  168. If you have any useful information, bug reports, praise, criticism, MONEY,
  169. or indeed anything else you think we might be interested in, then feel free
  170. to get in touch :-
  171.  
  172.     Richard Talbot-Watkins (rst20@cam.ac.uk)
  173.       Tel: 01223 500 997
  174.   
  175.  or Matthew Godbolt (matthew@willothewisp.demon.co.uk)
  176.  
  177.  
  178. Acknowledgements
  179. ================
  180.  
  181. Thanks are due to the following people who have helped make this emulator
  182. possible in one way or another:
  183.  
  184. * Marat Fayzullin, author of MasterGear and an SMS technical document which
  185.   has proved invaluable during development.
  186.  
  187. * Someone called "Jon", the author of another hugely useful SMS document
  188.   
  189. * James McKay, author of Massage.
  190.  
  191. * Gareth Moore, author of the Acorn port of MasterGear, and whose icons
  192.   we've nicked for the moment (hope you don't mind!)
  193.   
  194. * Mark Rison, for providing answers to the more subtle aspects of Z80A
  195.   emulation.
  196.  
  197. * Dave Sharp, for his excellent Acorn emulation page (http://www.come.to/
  198.   emulate) and for making sure we got a move on with this project!
  199.   
  200. * Super Magik Spiral Crew for their SMS documentation.
  201.  
  202. ...and everyone else out there (you know who you are) who have kept us
  203. (in)sane during the last few months and kept the flow of alcohol/caffeine
  204. coming...
  205.  
  206. Enjoy.
  207.  
  208.   - RTW/MG 17/03/98